home *** CD-ROM | disk | FTP | other *** search
/ Aminet 25 / Aminet 25 (1998)(GTI - Schatztruhe)[!][Jun 1998].iso / Aminet / mus / misc / RaveScope.lha / RaveScope / RaveScope.readme < prev   
Text File  |  1998-03-15  |  8KB  |  192 lines
  1. Short:     Fascinating "wrapped" scope for HiP/Delitracker
  2. Uploader:  c9713363@alinga.newcastle.edu.au (Erik Spåre)
  3. Author:    c9713363@alinga.newcastle.edu.au (Erik Spåre)
  4. Type:      mus/misc
  5. Version:   1.1
  6. Requires:  OS 3.0+, 68020+, 2MB+ fast, reqtools.library, HiP or DT
  7.  
  8. *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  9. *              RaveScope 1.1 Copyright © by Erik Spåre 980315               *
  10. *                           (Parsec/Phuture 303)                            *
  11. *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
  12.  
  13. INTRODUCTION
  14.  
  15.     This program implements a new kind of scope, a "wrapped monoscope".
  16.     Most modules look much better with a wrapped monoscope than they do
  17.     with the traditional one (the double mode in Delitracker's monoscope, or
  18.     the Spacescope in Eagleplayer). The Ravescope also has this "traditonal"
  19.     mode, as well as a new "alternative" mode.
  20.  
  21.  
  22. TEMPLATE
  23.  
  24.     After the programname you may specify one or more options:
  25.  
  26.     SCREEN/S,DISPLAYID/K,INVERT/S,WINLEFT/N/K,WINTOP/N/K,WINWIDTH/N/K,
  27.     WINHEIGHT/N/K,SCRWIDTH/N/K,SCRHEIGHT/N/K,WRAPACCURACY/N/K,
  28.     TRADACCURACY/N/K,ALTACCURACY/N/K,WRAPMODE/K,TRADMODE/K,ALTMODE/K
  29.     DELICONFIG/S,STROBO/S,VERSION/S
  30.  
  31.     SCREEN        To have the display on a private screen.
  32.  
  33.     DISPLAYID     Supply a hexadecimal DisplayID, for instance $21000
  34.                   (the dollar sign is required) for a low-res screen. If
  35.                   you leave out this you will get a screenmode requester
  36.                   instead.
  37.  
  38.     INVERT        To have a dark scope on a light background. (Well, depending
  39.                   on your workbench palette it may be the other way round when
  40.                   using a window as the display.)
  41.  
  42.     WINLEFT      Where you want the window positioned (x-pos), default = 0.
  43.  
  44.     WINTOP        Where you want the window positioned (y-pos), default = 11.
  45.  
  46.     WINWIDTH      Width of window (minus borders). Defaults to 280.
  47.  
  48.     WINHEIGHT     Height of window (minus borders). Defaults to 160.
  49.  
  50.     SCRWIDTH      Width of screen. Defaults to text-overscan width of selected
  51.                   displaymode.
  52.  
  53.     SCRHEIGHT     Height of screen. Defaults to text-overscan height of selected
  54.                   displaymode.
  55.  
  56.     WRAPACCURACY  Accuracy of the wrapped mode. Can be 25, 50, 100, 200
  57.                   300, 400, 500, 600, 700, 800 or 900 %. Defaults to 100%.
  58.                   Number of dots per display will be the circumference (in
  59.                   pixels) * percent * number of channels. (Do not write
  60.                   the percent sign when you specify this accuracy.)
  61.  
  62.     TRADACCURACY  Accuracy of the traditional mode. Cannot exceed 9999.
  63.                   Defaults to 500 (but this mode is off by default).
  64.                   Number of dots per display will be this value times
  65.                   number of channels. 
  66.  
  67.     ALTACCURACY   Accuracy of the alternative mode. Cannot exceed 9999.
  68.                   Defaults to 500 (but this mode is off by default).
  69.                   Number of dots per display will be this value times
  70.                   number of channels.
  71.  
  72.     WRAPMODE      Wrapped mode on or off. Defaults to on. (Write either
  73.                   on or off after this keyword.)
  74.  
  75.     TRADMODE      Traditional mode on or off. Defaults to off. (Write
  76.                   either on or off after this keyword.)
  77.  
  78.     ALTMODE       Alternative mode on or off. Defaults to off. (Write
  79.                   either on or off after this keyword.)
  80.  
  81.     DELICONFIG    Get the settings from DeliRave's configuration file. This
  82.                   is what DeliRave calls the RaveScope with. This option is
  83.                   executed before all the others, so any other specified option
  84.                   will override DeliRave's settings.
  85.  
  86.     STROBO        Turn on the strobo mode.
  87.  
  88.  
  89. KEYBOARD CONTROL
  90.  
  91.     The only way to control the scope while it's running is through the
  92.     keyboard.
  93.  
  94.     W - Wrapped mode on/off.
  95.  
  96.     T - Traditional mode on/off.
  97.  
  98.     A - Alternative mode on/off.
  99.  
  100.     S - Strobo mode on/off.
  101.  
  102.     Q - (or Escape) - Quit
  103.  
  104.     F - Switch between screen and window mode. Holding down a shift-key
  105.         when you press F will call the screenmode requester and open
  106.         a screen with the screenmode you select. F stands for Full-screen
  107.         which is what this is intended for, but any size is possible.
  108.  
  109.     To change the various scope-mode's accuracies, use the numerical keypad.
  110.     The keys 7, 8 and 9 will increase the wrapped, traditional and alternative
  111.     accuracy. The corresponding key below, 4, 5 or 6 will decrease it.
  112.  
  113.     To increase/decrease the dark part (unless you have invert switched on) in
  114.     the strobo mode, press shift + 7/4. Use 8/5 to control the bright part.
  115.  
  116.  
  117. LIMITATIONS
  118.  
  119.     If you select a non-native screen-mode, this program will (I hope)
  120.     refuse to run it, maybe it will even exit. This will be taken care of
  121.     in the next release, or when I get a gfx-card. If you have a gfx-card,
  122.     then please tell me what happens... (It should work fine in a window
  123.     though.)
  124.  
  125.  
  126. HINTS/WARNINGS
  127.  
  128.     * The Prodigy mp3's at 200% fullscreen (lores) with an 060 => kapow!
  129.  
  130.     * 100% usually looks the best for protracker modules. PS3M's or mp3's may
  131.       look better with 200% because they only output 2 channels. Do not
  132.       set the wrapped accuracy higher than this, it won't look good because
  133.       (I think) often the sample frequency isn't high enough.
  134.  
  135.     * PS3M's look much better with a high volume-boost and the main-volume
  136.       set to maximum in Hippoplayer.
  137.  
  138.     * DeliTracker gives the same data regardless of the sample-boost, but
  139.       the volume must be set to maximum.
  140.  
  141.     * Resizing is very slow because each time the size change, all the look-up
  142.       tables must be recalculated.
  143.  
  144.     ! Do not waste your life looking at this scope, as I have done!
  145.  
  146.  
  147. BACKGROUND
  148.  
  149.     4-5 years ago I saw a monoscope for the first time. (It was the
  150.     Quadraplayer's I think.)  When, some months later, I tried to make my
  151.     own (not having any idea of how it was done) I accidently invented this
  152.     "wrapped" scopemode, and to my delight it looked even better.
  153.  
  154.     I released a first version of it in a music disk-mag I was coding at
  155.     the time, Subculture. (The editor has now turned over to the dark side,
  156.     so there will probably not be a new issue.) There I explained how to do
  157.     it, hoping the scope would spread to my favourite module players. But it
  158.     didn't, either because no one saw it, or because it's a bit complicated
  159.     to implement. (It's not just a question of modifying the inner loop,
  160.     like when converting a plain scope to a monoscope.)
  161.  
  162.  
  163. HISTORY
  164.  
  165.     v1.0 (980209)
  166.  
  167.         ** The first release.
  168.  
  169.     v1.1 (980315)
  170.  
  171.         ** Added support for DeliTracker through the DeliRave genie.
  172.  
  173.         ** Added the keyword 'DELICONFIG' so that you can use DeliRave's
  174.            config settings with HippoPlayer as well.
  175.  
  176.         ** The wrapped mode has been prepared for use with 16 bit samples.
  177.            Neither Hippoplayer nor Delitracker gives their userprograms more
  178.            than 8 bits though, so this is quite pointless at the moment.
  179.  
  180.         ** Added a simple strobo-mode. This looks quite awful, but I seem to
  181.            remember that this can be fun when the room is dark and you're
  182.            drunk.
  183.  
  184.         ** Remembered to turn on compiler optimizations this time.
  185.  
  186.         BUGS: It is still very stable, much to my surprise. MPEGA player
  187.         did occasionally give enforcer hits, and I felt a bit guilty for this
  188.         because it has only happened when DeliRave has been active. (But on
  189.         the other hand, I only run enforcer when running DeliRave...)
  190.         Sometimes when a new module is loaded, it won't load until the
  191.         ravewindow is activated. I haven't looked into this yet.
  192.